home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / COMMUNIC / COMMUTIL / 2805A.ZIP / XRS45DOX.ZIP / REQUESTS.DOC < prev    next >
Text File  |  1991-04-22  |  4KB  |  81 lines
  1. This is a quick write-up on "User Requests" which are supported
  2. beginning with RaQmSeX 1.43 - I attempted to give perspectives
  3. for both the users and the SysOps, so some of the information may
  4. be just "FYI" if you are a user.      Mike  (22-April-1991)
  5.  
  6.  
  7. Version 1.44 supports "User Requests".  User requests at present are
  8. for either Files or Messages.  SysOps would call these file requests
  9. "pseudo File Requests", since they do not request files from other
  10. systems, but rather request a file available for download from the
  11. BBS.  SysOps have total control over User File Requests - a new file
  12. "DOWNLOAD.QMX" which uses the same format as "FLSEARCH.QMX" allows for
  13. greater flexibility by bypassing the normal methods, which would allow
  14. SysOps to define only certain areas as being requestable via RaQmSeX.
  15. If "DOWNLOAD.QMX" is not found, "FLSEARCH.QMX" is used instead.
  16.  
  17. User Message Requests are simply requests to turn an area on or off.
  18.  
  19. User Requests are performed at "Mailbag Upload" time.  To create User
  20. Requests, XRS users simply address a message to "XRS" with requests
  21. in the text portion of the message.  All forms of requests can be
  22. mixed and matched in a single message, and multiple messages per
  23. session are allowed as well (for now the subject is ignored).  Each
  24. request must be placed on a separate line!  Each line is checked and
  25. interpreted as follows:  If a '.' character is found, the line is
  26. always interpreted as a User File Request, the areas in DOWNLOAD.QMX
  27. (or FLSEARCH.QMX if no DOWNLOAD.QMX file exists) for which the user is
  28. eligible are each searched serially until a matching file is found,
  29. then the file is sent using the selected file transfer protocol (with
  30. Z-Modem auto-download, all of this could be easily automated!);
  31. otherwise, a User Message Request is assumed and the program looks
  32. through the tables trying to match either the AREA: tag _or_ the
  33. SysOp-defined 'topic' of the area or if the request is numeric, turns
  34. on that area number.  Using the area number is the easiest method.  A
  35. request to turn an area off is preceeded with a minus sign.  Wildcards
  36. and paths are not allowed!  If any user requests are found, a new
  37. *.PKT file is built without those messages.  Note that the "LOCAL"
  38. (area 0) should be used for User Requests, but RaQmSeX intercepts,
  39. interprets and removes them from any message area.
  40.  
  41. Version 1.44 of "XRS Door" (formerly "RAX"/"QMX"/"SeX" or "RQSeX")
  42. recognizes the "`" as an "escape" character for area requests, to
  43. force XRS Door to process it even with a period in the echo area
  44. name (like "comp.pc.prog.c" or whatever) - see example below.
  45.  
  46. Since XRS Door now supports more than message transport, the clock is
  47. watched and displayed to keep the user apprised of available time.
  48. In order to allow users more time if they use the RaQmSeX door, a new
  49. QMXSETUP.CFG parameter "FreeTime xx" will add 'xx' minutes to the time
  50. which the system shows as available.  NOTE THAT UNLESS YOU HAVE THE
  51. "*!" (don't enforce time limit) PARAMETER FOR YOUR MENU ENTRY, THE
  52. PROGRAM WILL LIKELY BE INTERRUPTED BY THE BBS WHEN TIME WOULD NORMALLY
  53. RUN OUT!  Again - this allows you to be more flexible.
  54.  
  55. An example:
  56.  
  57.     -Dr_Debug
  58.     C Programming Echo
  59.     SOMEFILE.ZIP
  60.     *.ZIP
  61.     C:\RA\USERS.BBS
  62.     XRS411AT.ZIP
  63.     78
  64.     NEW_ECHO
  65.     `comp.pc.biz
  66.  
  67. The first one would turn off "DR_DEBUG" echo (note - upper/lower/mixed
  68. cases are equivalent, and leading spaces are ignored).  The second one
  69. (assuming the SysOp named C_ECHO "C Programming Echo") would turn on an
  70. area, the third line would search DOWNLOAD.QMX for available areas, and
  71. attempt to find a matching file to send in them - it would send it with
  72. the user-selected protocol automatically if found.  Both the fourth and
  73. fifth requests are invalid - if any of these characters ('?', '*', ':',
  74. '\') are found a file request is ignored.  The next request would send
  75. the file XRS411AT.ZIP if it is found in an eligible area.  Next, there
  76. is an example of a numeric message area request - assuming area # 78 is
  77. available to you, it would be turned on.  The next to the last one would
  78. turn on an area named "NEW_ECHO" assuming it was found and the level and
  79. access flags check out, and the last one uses the "`" override to turn
  80. on an area with a period in the AREA: name (typical in uucp conferences).
  81.